GrIDsure endpoints
AllocateGrIDsure
AllocateGrIDsure(System.Collections.Generic.List{System.String},DataLayer.Entity.Transaction.BillingStyle,System.Boolean,System.Boolean,System.String)
Allocate GrIDsure tokens to a child account.
Parameters
Param: serials: List of serial numbers to allocate
Param: billingStyle: Billing style of the allocation: Allocation, Activation, Authentication or Transfer
Param: withCapacity: True to automatically add license capacity with the tokens
Param: isSale: True if this is a sale, false for rental.
Param: toOrganization: Account to allocate to
Returns:
- True if allocated successfully
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/AllocateGrIDsure"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<AllocateGrIDsure xmlns="http://www.cryptocard.com/blackshield/">
<serials>
<string>string</string>
<string>string</string>
</serials>
<billingStyle>Allocation or Activation or Authentication or Transfer</billingStyle>
<withCapacity>boolean</withCapacity>
<isSale>boolean</isSale>
<toOrganization>string</toOrganization>
</AllocateGrIDsure>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<AllocateGrIDsureResponse xmlns="http://www.cryptocard.com/blackshield/">
<AllocateGrIDsureResult>boolean</AllocateGrIDsureResult>
</AllocateGrIDsureResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<AllocateGrIDsure xmlns="http://www.cryptocard.com/blackshield/">
<serials>
<string>string</string>
<string>string</string>
</serials>
<billingStyle>Allocation or Activation or Authentication or Transfer</billingStyle>
<withCapacity>boolean</withCapacity>
<isSale>boolean</isSale>
<toOrganization>string</toOrganization>
</AllocateGrIDsure>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<AllocateGrIDsureResponse xmlns="http://www.cryptocard.com/blackshield/">
<AllocateGrIDsureResult>boolean</AllocateGrIDsureResult>
</AllocateGrIDsureResponse>
</soap12:Body>
</soap12:Envelope>
AuthenticateGrIDsureToken
AuthenticateGrIDsureToken(System.String,System.String,System.String)
Authenticate a GrIDsure token
Parameters
Param: userName: User with the token
Param: response: Reponse
Param: organization: Account
Returns
- True if successful
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/AuthenticateGrIDsureToken"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<AuthenticateGrIDsureToken xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<response>string</response>
<organization>string</organization>
</AuthenticateGrIDsureToken>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<AuthenticateGrIDsureTokenResponse xmlns="http://www.cryptocard.com/blackshield/">
<AuthenticateGrIDsureTokenResult>boolean</AuthenticateGrIDsureTokenResult>
</AuthenticateGrIDsureTokenResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<AuthenticateGrIDsureToken xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<response>string</response>
<organization>string</organization>
</AuthenticateGrIDsureToken>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<AuthenticateGrIDsureTokenResponse xmlns="http://www.cryptocard.com/blackshield/">
<AuthenticateGrIDsureTokenResult>boolean</AuthenticateGrIDsureTokenResult>
</AuthenticateGrIDsureTokenResponse>
</soap12:Body>
</soap12:Envelope>
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
GET /bsidca/BSIDCA.asmx/AuthenticateGrIDsureToken?userName=string&response=string&organization=string HTTP/1.1
Host: cloud.eu.safenetid.com
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="http://www.cryptocard.com/blackshield/">boolean</boolean>
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx/AuthenticateGrIDsureToken HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
userName=string&response=string&organization=string
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="http://www.cryptocard.com/blackshield/">boolean</boolean>
</ br>
DeallocateGrIDsure
DeallocateGrIDsure(System.Collections.Generic.List{System.String},System.Boolean,System.String,System.String)
De-allocate GrIDsure tokens from a child account.
Parameters
Param: serials: List of serials to de-allocate from the child account
Param: isSale: True if tokens are being sold back up the chain.
Param: intoContainer: Container to place the tokens into
Param: fromOrganization: Account to move tokens from
Returns:
- True if tokens are de-allocated
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/DeallocateGrIDsure"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<DeallocateGrIDsure xmlns="http://www.cryptocard.com/blackshield/">
<serials>
<string>string</string>
<string>string</string>
</serials>
<isSale>boolean</isSale>
<intoContainer>string</intoContainer>
<fromOrganization>string</fromOrganization>
</DeallocateGrIDsure>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<DeallocateGrIDsureResponse xmlns="http://www.cryptocard.com/blackshield/">
<DeallocateGrIDsureResult>boolean</DeallocateGrIDsureResult>
</DeallocateGrIDsureResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.eu.safenetid.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<DeallocateGrIDsure xmlns="http://www.cryptocard.com/blackshield/">
<serials>
<string>string</string>
<string>string</string>
</serials>
<isSale>boolean</isSale>
<intoContainer>string</intoContainer>
<fromOrganization>string</fromOrganization>
</DeallocateGrIDsure>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<DeallocateGrIDsureResponse xmlns="http://www.cryptocard.com/blackshield/">
<DeallocateGrIDsureResult>boolean</DeallocateGrIDsureResult>
</DeallocateGrIDsureResponse>
</soap12:Body>
</soap12:Envelope>
GetGrIDsurechallenge
GetGrIDsurechallenge(System.String,System.String)
Get a challenge string for a GrIDsure token. This string must be processed into an image and presented to the user.
Parameters
Param: userName: User who is requesting the challenge
Param: organization: Account
Returns
- GrIDsure challenge string
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/GetGrIDsurechallenge"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetGrIDsurechallenge xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<organization>string</organization>
</GetGrIDsurechallenge>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetGrIDsurechallengeResponse xmlns="http://www.cryptocard.com/blackshield/">
<GetGrIDsurechallengeResult>string</GetGrIDsurechallengeResult>
</GetGrIDsurechallengeResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetGrIDsurechallenge xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<organization>string</organization>
</GetGrIDsurechallenge>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<GetGrIDsurechallengeResponse xmlns="http://www.cryptocard.com/blackshield/">
<GetGrIDsurechallengeResult>string</GetGrIDsurechallengeResult>
</GetGrIDsurechallengeResponse>
</soap12:Body>
</soap12:Envelope>
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
GET /bsidca/BSIDCA.asmx/GetGrIDsurechallenge?userName=string&organization=string HTTP/1.1
Host: cloud.safenet-inc.com
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://www.cryptocard.com/blackshield/">string</string>
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx/GetGrIDsurechallenge HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
userName=string&organization=string
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://www.cryptocard.com/blackshield/">string</string>
ProvisionUsersGrIDsureTokens
ProvisionUsersGrIDsureTokens(System.Collections.Generic.List{System.String},System.String,System.String)
Provisions a list of users with GrIDsure tokens.
Parameters
Param: userNames: Names of the users to provision tokens to
Param: description: Provisioning task description
Param: organization: Account
Returns
A list in the same order as the user names provided:
| FailedToAddToBatch | Failed to add user to provisioning task |
| EmailSent | Success |
| UserHasNoEmail | Can't provision to the user as they have no e-mail address |
| FailedToSendEmail | Failed to send out the e-mail. Check e-mail settings for the account |
| CouldntGetToken | Couldn't find an available SMS or MP token to use for SMS provisioning |
| CouldntAssignToken | User could not be assigned an SMS token |
| UserHasActiveToken | Cannot provision password as the user has an active token |
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/ProvisionUsersGrIDsureTokens"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ProvisionUsersGrIDsureTokens xmlns="http://www.cryptocard.com/blackshield/">
<userNames>
<string>string</string>
<string>string</string>
</userNames>
<description>string</description>
<organization>string</organization>
</ProvisionUsersGrIDsureTokens>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ProvisionUsersGrIDsureTokensResponse xmlns="http://www.cryptocard.com/blackshield/">
<ProvisionUsersGrIDsureTokensResult>
<ProvisioningResult>FailedToAddToBatch or EmailSent or SMSSent or UserHasNoEmail or UserHasNoMobileNumber or FailedToSendEmail or FailedToSendSMS or FailedToSendSMS_NoCredits or CouldntGetToken or CouldntAssignToken or UserHasActiveToken or ProvisionSuccess</ProvisioningResult>
<ProvisioningResult>FailedToAddToBatch or EmailSent or SMSSent or UserHasNoEmail or UserHasNoMobileNumber or FailedToSendEmail or FailedToSendSMS or FailedToSendSMS_NoCredits or CouldntGetToken or CouldntAssignToken or UserHasActiveToken or ProvisionSuccess</ProvisioningResult>
</ProvisionUsersGrIDsureTokensResult>
</ProvisionUsersGrIDsureTokensResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ProvisionUsersGrIDsureTokens xmlns="http://www.cryptocard.com/blackshield/">
<userNames>
<string>string</string>
<string>string</string>
</userNames>
<description>string</description>
<organization>string</organization>
</ProvisionUsersGrIDsureTokens>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ProvisionUsersGrIDsureTokensResponse xmlns="http://www.cryptocard.com/blackshield/">
<ProvisionUsersGrIDsureTokensResult>
<ProvisioningResult>FailedToAddToBatch or EmailSent or SMSSent or UserHasNoEmail or UserHasNoMobileNumber or FailedToSendEmail or FailedToSendSMS or FailedToSendSMS_NoCredits or CouldntGetToken or CouldntAssignToken or UserHasActiveToken or ProvisionSuccess</ProvisioningResult>
<ProvisioningResult>FailedToAddToBatch or EmailSent or SMSSent or UserHasNoEmail or UserHasNoMobileNumber or FailedToSendEmail or FailedToSendSMS or FailedToSendSMS_NoCredits or CouldntGetToken or CouldntAssignToken or UserHasActiveToken or ProvisionSuccess</ProvisioningResult>
</ProvisionUsersGrIDsureTokensResult>
</ProvisionUsersGrIDsureTokensResponse>
</soap12:Body>
</soap12:Envelope>
ResetGrIDsureTokenPIP
ResetGrIDsureTokenPIP(System.String,System.Byte\[\],System.String,System.String)
Reset the PIP for a GrIDsure token using an initialization key from getGrIDsureTokenInitKey and the correct response.
Parameters
Param: userName: User with the token
Param: initKey: Initialization key from getGrIDsureTokenInitKey
Param: response: Response to the initialization key
Param: organization: Account
Returns
- True if the PIP was reset
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/ResetGrIDsureTokenPIP"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ResetGrIDsureTokenPIP xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<initKey>base64Binary</initKey>
<response>string</response>
<organization>string</organization>
</ResetGrIDsureTokenPIP>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ResetGrIDsureTokenPIPResponse xmlns="http://www.cryptocard.com/blackshield/">
<ResetGrIDsureTokenPIPResult>boolean</ResetGrIDsureTokenPIPResult>
</ResetGrIDsureTokenPIPResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ResetGrIDsureTokenPIP xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<initKey>base64Binary</initKey>
<response>string</response>
<organization>string</organization>
</ResetGrIDsureTokenPIP>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ResetGrIDsureTokenPIPResponse xmlns="http://www.cryptocard.com/blackshield/">
<ResetGrIDsureTokenPIPResult>boolean</ResetGrIDsureTokenPIPResult>
</ResetGrIDsureTokenPIPResponse>
</soap12:Body>
</soap12:Envelope>
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
GET /bsidca/BSIDCA.asmx/ResetGrIDsureTokenPIP?userName=string&initKey=string&initKey=string&response=string&organization=string HTTP/1.1
Host: cloud.safenet-inc.com
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="http://www.cryptocard.com/blackshield/">boolean</boolean>
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx/ResetGrIDsureTokenPIP HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
userName=string&initKey=string&initKey=string&response=string&organization=string
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="http://www.cryptocard.com/blackshield/">boolean</boolean>
getGrIDsureToken
getGrIDsureToken(System.String,System.String)
Get the GrIDsure token for a given user.
Parameters
Param: userName: User name
Param: organization: Account
Returns
- The user's GrIDsure token (if they have one)
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/getGrIDsureToken"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getGrIDsureToken xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<organization>string</organization>
</getGrIDsureToken>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getGrIDsureTokenResponse xmlns="http://www.cryptocard.com/blackshield/">
<getGrIDsureTokenResult>
<challengeIssued>boolean</challengeIssued>
<isICEToken>boolean</isICEToken>
<OwnerName>string</OwnerName>
<Organization>string</Organization>
<OwningOrganization>string</OwningOrganization>
<State>BASE_INVENTORY or NOT_INITIALIZED or REVOKED or INITIALIZED or CORRUPTED_INVENTORY or BASE_ALLOCATED or ALLOCATED or BASE_ASSIGNED or MANUALLY_ASSIGNED or ENROLLED_PIN_CHANGE or ENROLLMENT_PENDING or BASE_ACTIVE or ACTIVE_TOKEN or PIN_CHANGE or BASE_SUSPENDED or MANUAL_SUSPENSION or RULE_SUSPENSION or BASE_LOCKED or SERVER_LOCK or USER_LOCK or PIN_CHANGE_LOCK or CORRUPTED or BASE_LOST_FAILED or LOST_TOKEN or DAMAGED_TOKEN or BASE_DELETED or MANUAL_REMOVE or AUTO_REMOVE or BASE_PURGED or PURGED_TOKEN</State>
<PINSetDate>string</PINSetDate>
<ActivationTime>string</ActivationTime>
<UnlockTime>string</UnlockTime>
<StateSetDate>string</StateSetDate>
<LastAuthDate>string</LastAuthDate>
<LastSuccessDate>string</LastSuccessDate>
<Inittime>string</Inittime>
<Display>string</Display>
<OTPTTL>int</OTPTTL>
<OtpLength>int</OtpLength>
<ActivationCount>int</ActivationCount>
<EncryptionKey>base64Binary</EncryptionKey>
<NonHSMKey>base64Binary</NonHSMKey>
<ChallengeBase>base64Binary</ChallengeBase>
<AuthAttempts>int</AuthAttempts>
<Message>string</Message>
<LastChallengeDate>string</LastChallengeDate>
<ExpiryDate>string</ExpiryDate>
<IsTimeBased>boolean</IsTimeBased>
<TimeInterval>int</TimeInterval>
<AuthVersion>GOLD or CUSTOM or OATH or V4 or V5 or V6 or V7</AuthVersion>
<ContainerName>string</ContainerName>
<DeviceName>string</DeviceName>
</getGrIDsureTokenResult>
</getGrIDsureTokenResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<getGrIDsureToken xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<organization>string</organization>
</getGrIDsureToken>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<getGrIDsureTokenResponse xmlns="http://www.cryptocard.com/blackshield/">
<getGrIDsureTokenResult>
<challengeIssued>boolean</challengeIssued>
<isICEToken>boolean</isICEToken>
<OwnerName>string</OwnerName>
<Organization>string</Organization>
<OwningOrganization>string</OwningOrganization>
<State>BASE_INVENTORY or NOT_INITIALIZED or REVOKED or INITIALIZED or CORRUPTED_INVENTORY or BASE_ALLOCATED or ALLOCATED or BASE_ASSIGNED or MANUALLY_ASSIGNED or ENROLLED_PIN_CHANGE or ENROLLMENT_PENDING or BASE_ACTIVE or ACTIVE_TOKEN or PIN_CHANGE or BASE_SUSPENDED or MANUAL_SUSPENSION or RULE_SUSPENSION or BASE_LOCKED or SERVER_LOCK or USER_LOCK or PIN_CHANGE_LOCK or CORRUPTED or BASE_LOST_FAILED or LOST_TOKEN or DAMAGED_TOKEN or BASE_DELETED or MANUAL_REMOVE or AUTO_REMOVE or BASE_PURGED or PURGED_TOKEN</State>
<PINSetDate>string</PINSetDate>
<ActivationTime>string</ActivationTime>
<UnlockTime>string</UnlockTime>
<StateSetDate>string</StateSetDate>
<LastAuthDate>string</LastAuthDate>
<LastSuccessDate>string</LastSuccessDate>
<Inittime>string</Inittime>
<Display>string</Display>
<OTPTTL>int</OTPTTL>
<OtpLength>int</OtpLength>
<ActivationCount>int</ActivationCount>
<EncryptionKey>base64Binary</EncryptionKey>
<NonHSMKey>base64Binary</NonHSMKey>
<ChallengeBase>base64Binary</ChallengeBase>
<AuthAttempts>int</AuthAttempts>
<Message>string</Message>
<LastChallengeDate>string</LastChallengeDate>
<ExpiryDate>string</ExpiryDate>
<IsTimeBased>boolean</IsTimeBased>
<TimeInterval>int</TimeInterval>
<AuthVersion>GOLD or CUSTOM or OATH or V4 or V5 or V6 or V7</AuthVersion>
<ContainerName>string</ContainerName>
<DeviceName>string</DeviceName>
</getGrIDsureTokenResult>
</getGrIDsureTokenResponse>
</soap12:Body>
</soap12:Envelope>
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
GET /bsidca/BSIDCA.asmx/getGrIDsureToken?userName=string&organization=string HTTP/1.1
Host: cloud.safenet-inc.com
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<Token xmlns="http://www.cryptocard.com/blackshield/">
<challengeIssued>boolean</challengeIssued>
<isICEToken>boolean</isICEToken>
<OwnerName>string</OwnerName>
<Organization>string</Organization>
<OwningOrganization>string</OwningOrganization>
<State>BASE_INVENTORY or NOT_INITIALIZED or REVOKED or INITIALIZED or CORRUPTED_INVENTORY or BASE_ALLOCATED or ALLOCATED or BASE_ASSIGNED or MANUALLY_ASSIGNED or ENROLLED_PIN_CHANGE or ENROLLMENT_PENDING or BASE_ACTIVE or ACTIVE_TOKEN or PIN_CHANGE or BASE_SUSPENDED or MANUAL_SUSPENSION or RULE_SUSPENSION or BASE_LOCKED or SERVER_LOCK or USER_LOCK or PIN_CHANGE_LOCK or CORRUPTED or BASE_LOST_FAILED or LOST_TOKEN or DAMAGED_TOKEN or BASE_DELETED or MANUAL_REMOVE or AUTO_REMOVE or BASE_PURGED or PURGED_TOKEN</State>
<PINSetDate>string</PINSetDate>
<ActivationTime>string</ActivationTime>
<UnlockTime>string</UnlockTime>
<StateSetDate>string</StateSetDate>
<LastAuthDate>string</LastAuthDate>
<LastSuccessDate>string</LastSuccessDate>
<Inittime>string</Inittime>
<Display>string</Display>
<OTPTTL>int</OTPTTL>
<OtpLength>int</OtpLength>
<ActivationCount>int</ActivationCount>
<EncryptionKey>base64Binary</EncryptionKey>
<NonHSMKey>base64Binary</NonHSMKey>
<ChallengeBase>base64Binary</ChallengeBase>
<AuthAttempts>int</AuthAttempts>
<Message>string</Message>
<LastChallengeDate>string</LastChallengeDate>
<ExpiryDate>string</ExpiryDate>
<IsTimeBased>boolean</IsTimeBased>
<TimeInterval>int</TimeInterval>
<AuthVersion>GOLD or CUSTOM or OATH or V4 or V5 or V6 or V7</AuthVersion>
<ContainerName>string</ContainerName>
<DeviceName>string</DeviceName>
</Token>
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx/getGrIDsureToken HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
userName=string&organization=string
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<Token xmlns="http://www.cryptocard.com/blackshield/">
<challengeIssued>boolean</challengeIssued>
<isICEToken>boolean</isICEToken>
<OwnerName>string</OwnerName>
<Organization>string</Organization>
<OwningOrganization>string</OwningOrganization>
<State>BASE_INVENTORY or NOT_INITIALIZED or REVOKED or INITIALIZED or CORRUPTED_INVENTORY or BASE_ALLOCATED or ALLOCATED or BASE_ASSIGNED or MANUALLY_ASSIGNED or ENROLLED_PIN_CHANGE or ENROLLMENT_PENDING or BASE_ACTIVE or ACTIVE_TOKEN or PIN_CHANGE or BASE_SUSPENDED or MANUAL_SUSPENSION or RULE_SUSPENSION or BASE_LOCKED or SERVER_LOCK or USER_LOCK or PIN_CHANGE_LOCK or CORRUPTED or BASE_LOST_FAILED or LOST_TOKEN or DAMAGED_TOKEN or BASE_DELETED or MANUAL_REMOVE or AUTO_REMOVE or BASE_PURGED or PURGED_TOKEN</State>
<PINSetDate>string</PINSetDate>
<ActivationTime>string</ActivationTime>
<UnlockTime>string</UnlockTime>
<StateSetDate>string</StateSetDate>
<LastAuthDate>string</LastAuthDate>
<LastSuccessDate>string</LastSuccessDate>
<Inittime>string</Inittime>
<Display>string</Display>
<OTPTTL>int</OTPTTL>
<OtpLength>int</OtpLength>
<ActivationCount>int</ActivationCount>
<EncryptionKey>base64Binary</EncryptionKey>
<NonHSMKey>base64Binary</NonHSMKey>
<ChallengeBase>base64Binary</ChallengeBase>
<AuthAttempts>int</AuthAttempts>
<Message>string</Message>
<LastChallengeDate>string</LastChallengeDate>
<ExpiryDate>string</ExpiryDate>
<IsTimeBased>boolean</IsTimeBased>
<TimeInterval>int</TimeInterval>
<AuthVersion>GOLD or CUSTOM or OATH or V4 or V5 or V6 or V7</AuthVersion>
<ContainerName>string</ContainerName>
<DeviceName>string</DeviceName>
</Token>
getGrIDsureTokenInitKey
getGrIDsureTokenInitKey(System.String,System.String)
Get the initialization Key for a GrIDsure token.
Parameters
Param: userName: User with a GrIDsure token
Param: organization: Account
Returns
- Initialization key
SOAP 1.1 sample
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cryptocard.com/blackshield/getGrIDsureTokenInitKey"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getGrIDsureTokenInitKey xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<organization>string</organization>
</getGrIDsureTokenInitKey>
</soap:Body>
</soap:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<getGrIDsureTokenInitKeyResponse xmlns="http://www.cryptocard.com/blackshield/">
<getGrIDsureTokenInitKeyResult>base64Binary</getGrIDsureTokenInitKeyResult>
</getGrIDsureTokenInitKeyResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2 sample
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<getGrIDsureTokenInitKey xmlns="http://www.cryptocard.com/blackshield/">
<userName>string</userName>
<organization>string</organization>
</getGrIDsureTokenInitKey>
</soap12:Body>
</soap12:Envelope>
Response:
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<getGrIDsureTokenInitKeyResponse xmlns="http://www.cryptocard.com/blackshield/">
<getGrIDsureTokenInitKeyResult>base64Binary</getGrIDsureTokenInitKeyResult>
</getGrIDsureTokenInitKeyResponse>
</soap12:Body>
</soap12:Envelope>
HTTP GET sample
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
Request:
GET /bsidca/BSIDCA.asmx/getGrIDsureTokenInitKey?userName=string&organization=string HTTP/1.1
Host: cloud.safenet-inc.com
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<base64Binary xmlns="http://www.cryptocard.com/blackshield/">base64Binary</base64Binary>
HTTP POST sample
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
Request:
POST /bsidca/BSIDCA.asmx/getGrIDsureTokenInitKey HTTP/1.1
Host: cloud.safenet-inc.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
userName=string&organization=string
Response:
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<base64Binary xmlns="http://www.cryptocard.com/blackshield/">base64Binary</base64Binary>